---
Title: MPG123
TitleContent: MPG123: Tocador de mp3 leve para o terminal
Description: MPG123 é um tocador de mp3 leve para terminal. Guia de comandos, equalização e reprodução de streams
Template: wiki
Keywords: Áudio, MP3, ClI
Author: pekman
Published: 2018-11-05
Modified: 2018-11-06
Tag: Multimídia,Tocadores, Áudio, MP3, Streams, CLI
---

O [mpg123](http://mpg123.de/) é um tocador de música para sistemas operacionais GNU/Linux e UNIX que reproduz arquivos de áudio com extensão **mp3**, executado através de comandos em um emulador de terminal, é extremamente leve, rápido e intuitivo.

## Características do mpg123

1. ocupa pouco espaço no disco, exatos 723,00 KiB
2. extremamente leve, consome 2 a 6 mb de memória RAM dependendo da arquitetura (32 ou 64 bits)
3. extremamente responsivo
4. suporte a equalização
5. sintaxe (comandos) simples
6. reproduz streaming de áudio no formato mp3
7. reproduz diretórios em níveis recursivos

## Instalando o mpg123

O mpg123 está presente no repositório das distribuições. Use o gerenciador de pacotes da sua [distribuição](/wiki/distros/) para fazer a instalação.

## Equalizando o áudio no mpg123

A equalização no mpg123 é configurada em modo texto, crie um arquivo oculto na pasta home do usuário com o nome .mpg_equal.txt.

```
cd ~/ && touch .mpg_equal.txt
```

Abra o arquivo em seu editor de texto preferido, cole o conteúdo abaixo e salve, ou faça o download clicando no link abaixo.

```
# 32 canais de áudio: esquerdo e direito
# Ordenados do mais grave para o mais agudo
1.2 1.2
1.2 1.2
1.2 1.2
1.2 1.2
1.2 1.2
1.2 1.2
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
0.5 0.5
5.0 5.0
5.0 5.0
5.0 5.0
5.0 5.0
5.0 5.0
5.0 5.0
```
## Argumentos do mpg123

O mpg123 possui inúmeros argumentos que possibilitam diferentes opções na formação do comando ao executar um arquivo mp3, como este artigo têm um caráter prático irei explanar apenas os que serão usados para criar as linhas de comandos usadas neste texto. Para conferir todas as opções do player acesse a [manpage online](https://linux.die.net/man/1/mpg123) ou use o comando:

```
man mpg123
```

* −−title ⇒ exibe o título da música que está sendo executada na barra de status do terminal
* −−control ⇒ habilita os atalhos do player
* −−continue ⇒ habilita o continuar a partir do arquivo que estava sendo executado antes fechar o player
* −v ⇒ habilita o modo verbose
* −E ⇒ invoca o arquivo de equalização que criamos no passo anterior
* −−stereo ⇒ habilita a reprodução em mais de um canal e melhora a qualidade do áudio
* −−float ⇒ força a codificação em 32 bits, melhorando a qualidade do áudio
* −−rva-mix ⇒ normaliza o áudio, usando uma média obtida após combinação de frequência de todas as músicas da fila de reprodução atual
* −−long-tag ⇒ exibe informações detalhadas do arquivo em reprodução, artista, álbum, ano…

## Comandos do mpg123

Para reproduzir um arquivo mp3 você pode simplesmente invocar o player e indicar o caminho do arquivo. Caracteres coringas (*) são aceitos:

```
mpg123 ~/pasta/arquivo.mp3
mpg123 ~/pasta/*.mp3
```

Reproduzir uma pasta em loop infinito até o player ser interrompido manualmente, **CTRL + c**.

```
mpg123 --random ~/pasta/
```

Combinação avançada de comandos para reproduzir todos arquivos de uma pasta (veja a seção acima para identificar a ação de cada argumento), lembre de substituir “pasta” pelo caminho do diretório que você deseja reproduzir os arquivos mp3.

```
mpg123 --continue -v -E ~/.mpg_equal.txt --stereo --float --rva-mix --control --title --long-tag ~/pasta/mp3
```

Combinação avançada de comandos para reproduzir todos os arquivos de uma pasta em modo embaralhado e recursivo. lembre de substituir “pasta” pelo caminho do diretório que você deseja reproduzir os arquivos mp3. Esse comando não permite o uso de atalhos, para avançar para a próxima faixa de áudio use a tecla **CTRL + c**.

```
find . -iname "*.mp3" | mpg123 -E ~/.mpg_equal.txt --stereo --float --rva-mix --title --long-tag -Z --list - ~/pasta
```

Combinação avançada de comandos para reproduzir todos os arquivos do seu computador em modo embaralhado e recursivo . Esse comando não permite o uso de atalhos, para avançar para a próxima faixa de áudio use a tecla **CTRL + c**.

```
find . -iname "*.mp3" | mpg123 -E ~/.mpg_equal.txt --stereo --float --rva-mix --title --long-tag -Z --list -
```

Comando para reproduzir streaming no formato mp3. Lembre-se, só funcionará se o fluxo do streaming estiver no formato mp3, não esqueça de colocar o link no lugar de streaming.mp3 no comando abaixo.

```
mpg123 --stereo --float  --control -v -v -@ streamin.mp3
```

## Lista de aliases

Os aliases aqui apresentados são apenas sugestões do autor. Esses “apelidos” podem ser escolhidos pelo usuário da forma que bem entender, porém cuidado para que os mesmos não tenha o nome de um comando já existente.

Abra o arquivo oculto localizado na pasta do usuário .bashrc[^1] e adicione as linhas baixo:

Executar os arquivos de uma pasta usando o comando **mpg**:

```
alias mpg='mpg123 --continue -v -E ~/.mpg_equal.txt --stereo --float --rva-mix --control --title --long-tag *mp3'
```

Executar os arquivos de pasta em modo recursivo usando o comando **mpgr**:

```
alias mpgr='find . -iname "*.mp3" | mpg123 -E ~/.mpg_equal.txt --stereo --float --rva-album --rva-mix --title --fuzzy --long-tag -Z --list -'
```

Executar um streaming mp3 usando o comando **mpgs**:

```
alias mps='mpg123 --stereo --float  --control -v -v -@'
```

A fim de deixar o manuseio do player ainda mais fácil e prático vamos criar aliases para os diretórios de áudio. Abaixo seguem alguns exemplos que eu uso diariamente. Fique atento com as letras maiúsculas e minúsculas (case sensitive).

```
alias dm='cd ~/Músicas/
alias dmd='cd ~/Músicas/Dance
alias dmp='cd ~/Músicas/Pop
alias dmr='cd ~/Músicas/Rock'
alias dmr2='cd ~/Músicas/MPB'
alias dms='cd ~/Músicas/Sertanejo'
alias dms2='cd ~/Músicas/Shows'
alias dms3='cd ~/Músicas/Synthpop'
```

Neste exemplo as músicas estão organizadas por gênero, mas você pode criar diversos aliases para artistas. Por exemplo:

```
alias depeche='cd ~/Músicas/Synthpop/Depeche-Mode'
alias metallica='cd ~/Músicas/Rock/Metallica'
```

Os aliases aqui sugeridos podem ser nomeados da forma que você achar melhor, ficando ao seu critério.

## Atalhos do mpg123

* h ⇒ exibe a lista de atalhos
* s ⇒ pausa a música, acionado novamente retorna a reprodução do áudio.
* f ⇒ avança para próxima música da pasta ou lista de reprodução
* d ⇒ recua para a música anterior da pasta ou lista de reprodução
* p ⇒ reproduz o frame atual em loop (um bug mostra na tela que o player está em pausa)
* . ⇒ o ponto (.) avança os frames da música
* , ⇒ a vírgula (,) recua os frames da música
* : ⇒ dois pontos (:) avança os frames da música de forma rápida
* ; ⇒ ponto e vírgula (;) recua os frames da música de forma rápida
* > ⇒ altera a velocidade da reprodução, reproduzindo o áudio mais rápido
* < ⇒ altera a velocidade da reprodução, reproduzindo o áudio mais devagar
* "+" ⇒ aumenta o volume
* – ⇒ diminui o volume
* r ⇒ ativa a normalização do volume
* v ⇒ ativa/desativa o modo verbose
* l ⇒ lista todos os arquivos que estão em reprodução na playlist atual
* t ⇒ lista as informações das tags da música; artista, ano, gênero…
* m ⇒ exibe informações do cabeçalho do arquivo sendo reproduzido; Freq (frequência), Channels (canais)…
* c ⇒ eleva o pico de reprodução
* x ⇒ diminui o pico de reprodução
* k ⇒ imprimir posição atual na lista de reprodução ou faixa, se você abrir esta playlist em outro player a reprodução começa de onde parou
* q ⇒ fecha o player
* 1/0 ⇒ a numeração de 1 a 0 representa pontos exatos em porcentagens nos quais podemos acender. 1 marca o início da faixa, 2 avança para o ponto de reprodução em 20%, seguindo a sequencia.

## Veja também

[Mpg123 - site oficial](http://www.mpg123.org/features.shtml) | [Commands using mpg123 - commandlinefu](http://www.commandlinefu.com/commands/using/mpg123)

## Feedback

Editor: pekman  
email: pekman@gnulinux.net.br

[^1]: Pode ser usado no ZSH ou Fish
